<documentation title="Aligning Blocks of Assignments">
    <standard>
    <![CDATA[
      There should be one space on either side of an equals sign used to assign a value to a variable. In the case of a block of related assignments, more space may be inserted to promote readability.
    ]]>
    </standard>
    <code_comparison>
        <code title="Equals signs aligned">
        <![CDATA[
$shortVar        <em>=</em> (1 + 2);
$veryLongVarName <em>=</em> 'string';
$var             <em>=</em> foo($bar, $baz, $quux);
        ]]>
        </code>
        <code title="Not aligned; harder to read">
        <![CDATA[
$shortVar <em>=</em> (1 + 2);
$veryLongVarName <em>=</em> 'string';
$var <em>=</em> foo($bar, $baz, $quux);
        ]]>
        </code>
    </code_comparison>
    <standard>
    <![CDATA[
      When using plus-equals, minus-equals etc. still ensure the equals signs are aligned to one space after the longest variable name.
    ]]>
    </standard>
    <code_comparison>
        <code title="Equals signs aligned; only one space after longest var name">
        <![CDATA[
$shortVar       <em>+= </em>1;
$veryLongVarName<em> = </em>1;
        ]]>
        </code>
        <code title="Two spaces after longest var name">
        <![CDATA[
$shortVar       <em> += </em>1;
$veryLongVarName<em>  = </em>1;
        ]]>
        </code>
    </code_comparison>
    <code_comparison>
        <code title="Equals signs aligned">
        <![CDATA[
$shortVar       <em>  = </em>1;
$veryLongVarName<em> -= </em>1;
        ]]>
        </code>
        <code title="Equals signs not aligned">
        <![CDATA[
$shortVar       <em> = </em>1;
$veryLongVarName<em> -= </em>1;
        ]]>
        </code>
    </code_comparison>
</documentation>
